-- *****************************************************************
-- REDSTONE-PING-MIB
--
-- Implementation of the IETF's Distributed Management group for
-- the Remote Ping operation, folded into the Redstone enterprise.
--
-- *****************************************************************--
-- This document is the enterprise implementation of the Remote Ping
-- MIB, on its 8th draft revision. In order to avoid naming and oid
-- conflicts, all objects had the "rs" prefix added, and the ping
-- subtree had been moved into the Redstone enterprise. The intent
-- is to offer support to the ping mib as soon as it becomes an RFC,
-- as well as this particular revision.
--REDSTONE-PING-MIB DEFINITIONS::=BEGINIMPORTSMODULE-IDENTITY,OBJECT-TYPE,Integer32,Unsigned32,NOTIFICATION-TYPE,OBJECT-IDENTITYFROM SNMPv2-SMI -- RFC2578TEXTUAL-CONVENTION,RowStatus,StorageType,DateAndTime,TruthValueFROM SNMPv2-TC -- RFC2579MODULE-COMPLIANCE,OBJECT-GROUP,
NOTIFICATION-GROUPFROM SNMPv2-CONF -- RFC2580InterfaceIndexOrZero-- RFC2233FROM IF-MIB
SnmpAdminStringFROM SNMP-FRAMEWORK-MIB -- RFC2571rsMgmt
FROM REDSTONE-SMI;rsPingMIB MODULE-IDENTITYLAST-UPDATED"200003010000Z"-- 1 March 2000ORGANIZATION"Unisphere Solutions Inc."CONTACT-INFO"
Unisphere Solutions, Inc.
5 Carlisle Road
Westford MA 01886
USA
Tel: +1-978-692-1999
Email: mib@redstonecom.com
This is a modified version of the IETF Distributed
Management Working Group for the DISMAN-PING-MIB.
Once the DISMAN-PING-MIB becomes a RFC, both standard
and this MIB will be supported. For more details about
IETF Distributed Management group, visit:
http://www.ietf.org/html.charters/disman-charter.html
"DESCRIPTION"The rsPing MIB (REDSTONE-PING-MIB) provides the capability of
controlling the use of the ping function at a remote
host."-- Revision historyREVISION"200003010000Z"-- 1 March 2000DESCRIPTION"Initial version, created from Internet-Draft, revision 8."::={ rsMgmt 39}
-- Textual ConventionsRsPingInetAddressType ::=TEXTUAL-CONVENTIONSTATUScurrentDESCRIPTION"A value that represents a type of Internet address.
unknown(0) An unknown address type. This value MUST
be used if the value of the corresponding
RsPingInetAddress object is a zero-length string.
It may also be used to indicate an IP address
which is not in one of the formats defined
below.
ipv4(1) An IPv4 address as defined by the
InetAddressIPv4 textual convention.
ipv6(2) An IPv6 address as defined by the
InetAddressIPv6 textual convention.
dns(16) A DNS domain name as defined by the
InetAddressDNS textual convention.
Each definition of a concrete RsPingInetAddressType value must be
accompanied by a definition of a textual convention for use
with that RsPingInetAddressType.
The RsPingInetAddressType textual convention SHOULD NOT be subtyped
in object type definitions to support future extensions. It
MAY be subtyped in compliance statements in order to require
only a subset of these address types for a compliant
implementation."SYNTAXINTEGER{unknown(0),ipv4(1),ipv6(2),dns(16)-- align with AddressFamilyNumbers in}-- IANA-ADDRESS-FAMILY-NUMBERS-MIB
RsPingInetAddress ::=TEXTUAL-CONVENTIONSTATUScurrentDESCRIPTION"Denotes a generic Internet address.
An RsPingInetAddress value is always interpreted within the
context of an RsPingInetAddressType value. The RsPingInetAddressType
object which defines the context must be registered
immediately before the object which uses the RsPingInetAddress
textual convention. In other words, the object identifiers
for the RsPingInetAddressType object and the RsPingInetAddress object
MUST have the same length and the last sub-identifier of
the RsPingInetAddressType object MUST be 1 less than the last
sub-identifier of the RsPingInetAddress object.
When this textual convention is used as the syntax of an
index object, there may be issues with the limit of 128
sub-identifiers specified in SMIv2, STD 58. In this case,
the OBJECT-TYPE declaration MUST include a 'SIZE' clause
to limit the number of potential instance sub-identifiers."SYNTAXOCTETSTRING(SIZE(0..255))RsPingOperationResponseStatus ::=TEXTUAL-CONVENTIONSTATUScurrentDESCRIPTION"Used to report the result of an operation:
responseReceived(1) - Operation completes successfully.
unknown(2) - Operation failed due to unknown error.
internalError(3) - An implementation detected an error
in its own processing that caused an operation
to fail.
requestTimedOut(4) - Operation failed to receive a
valid reply within the time limit imposed on it.
unknownDestinationAddress(5) - Invalid destination
address.
noRouteToTarget(6) - Could not find a route to target.
interfaceInactiveToTarget(7) - The interface to be
used in sending a probe is inactive without an
alternate route existing.
arpFailure(8) - Unable to resolve a target address to a
media specific address.
maxConcurrentLimitReached(9)F - The maximum number of
concurrent active operations would have been exceeded
if the corresponding operation was allowed.
unableToResolveDnsName(10) - The DNS name specified was
unable to be mapped to an IP address.
invalidHostAddress(11) - The IP address for a host
has been determined to be invalid. Examples of this
are broadcast or multicast addresses."SYNTAXINTEGER{responseReceived(1),unknown(2),internalError(3),requestTimedOut(4),unknownDestinationAddress(5),noRouteToTarget(6),interfaceInactiveToTarget(7),arpFailure(8),maxConcurrentLimitReached(9),
unableToResolveDnsName(10),invalidHostAddress(11)}-- Top level structure of the MIBrsPingNotifications OBJECTIDENTIFIER::={ rsPingMIB 0}rsPingObjects OBJECTIDENTIFIER::={ rsPingMIB 1}rsPingConformance OBJECTIDENTIFIER::={ rsPingMIB 2}-- The registration node (point) for rsPing implementation typesrsPingImplementationTypeDomains OBJECTIDENTIFIER::={ rsPingMIB 3}rsPingIcmpEcho OBJECT-IDENTITYSTATUScurrentDESCRIPTION"Indicates that an implementation is using the Internet
Control Message Protocol (ICMP) 'ECHO' facility."::={ rsPingImplementationTypeDomains 1}rsPingUdpEcho OBJECT-IDENTITYSTATUScurrentDESCRIPTION"Indicates that an implementation is using the UDP echo
port (7)."REFERENCE"RFC 862, 'Echo Protocol'."::={ rsPingImplementationTypeDomains 2}rsPingSnmpQuery OBJECT-IDENTITYSTATUScurrentDESCRIPTION"Indicates that an implementation is an SNMP query to
calculate a round trip time."::={ rsPingImplementationTypeDomains 3}rsPingTcpConnectionAttempt OBJECT-IDENTITYSTATUScurrentDESCRIPTION"Indicates that an implementation is attempting to
connect to a TCP port in order to calculate a round
trip time."::={ rsPingImplementationTypeDomains 4}-- Simple Object DefinitionsrsPingMaxConcurrentRequests OBJECT-TYPESYNTAXUnsigned32UNITS"requests"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The maximum number of concurrent active rsPing requests
that are allowed within an agent implementation. A value
of 0 for this object implies that there is no limit for
the number of concurrent active requests in effect."DEFVAL{10}::={ rsPingObjects 1}
-- RsPing Control TablersPingCtlTable OBJECT-TYPESYNTAXSEQUENCEOF RsPingCtlEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Defines the rsPing Control Table for providing, via SNMP,
the capability of performing rsPing operations at
a remote host. The results of these operations are
stored in the rsPingResultsTable and the
rsPingProbeHistoryTable."::={ rsPingObjects 2}rsPingCtlEntry OBJECT-TYPESYNTAX RsPingCtlEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Defines an entry in the rsPingCtlTable. The first index
element, rsPingCtlOwnerIndex, is of type SnmpAdminString,
a textual convention that allows for use of the SNMPv3
View-Based Access Control Model (RFC 2575 [11], VACM)
and allows an management application to identify its
entries. The second index, rsPingCtlTestName (also an
SnmpAdminString), enables the same management
application to have multiple outstanding requests."INDEX{
rsPingCtlOwnerIndex,
rsPingCtlTestName
}::={ rsPingCtlTable 1}
RsPingCtlEntry ::=SEQUENCE{
rsPingCtlOwnerIndex SnmpAdminString,
rsPingCtlTestName SnmpAdminString,
rsPingCtlTargetAddressType RsPingInetAddressType,
rsPingCtlTargetAddress RsPingInetAddress,
rsPingCtlDataSize Unsigned32,
rsPingCtlTimeOut Unsigned32,
rsPingCtlProbeCount Unsigned32,
rsPingCtlAdminStatus INTEGER,
rsPingCtlDataFill OCTETSTRING,
rsPingCtlFrequency Unsigned32,
rsPingCtlMaxRows Unsigned32,
rsPingCtlStorageType StorageType,
rsPingCtlTrapGeneration BITS,
rsPingCtlTrapProbeFailureFilter Unsigned32,
rsPingCtlTrapTestFailureFilter Unsigned32,
rsPingCtlType OBJECTIDENTIFIER,
rsPingCtlDescr SnmpAdminString,
rsPingCtlSourceAddressType RsPingInetAddressType,
rsPingCtlSourceAddress RsPingInetAddress,
rsPingCtlIfIndex InterfaceIndexOrZero,
rsPingCtlByPassRouteTable TruthValue,
rsPingCtlDSField Unsigned32,
rsPingCtlRowStatus RowStatus}rsPingCtlOwnerIndex OBJECT-TYPESYNTAXSnmpAdminString(SIZE(0..32))MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"To facilitate the provisioning of access control by a
security administrator using the View-Based Access
Control Model (RFC 2575, VACM) for tables in which
multiple users may need to independently create or
modify entries, the initial index is used as an 'owner
index'. Such an initial index has a syntax of
SnmpAdminString, and can thus be trivially mapped to a
securityName or groupName as defined in VACM, in
accordance with a security policy.
When used in conjunction with such a security policy all
entries in the table belonging to a particular user (or
group) will have the same value for this initial index.
For a given user's entries in a particular table, the
object identifiers for the information in these entries
will have the same subidentifiers (except for the 'column'
subidentifier) up to the end of the encoded owner index.
To configure VACM to permit access to this portion of the
table, one would create vacmViewTreeFamilyTable entries
with the value of vacmViewTreeFamilySubtree including
the owner index portion, and vacmViewTreeFamilyMask
'wildcarding' the column subidentifier. More elaborate
configurations are possible."::={ rsPingCtlEntry 1}rsPingCtlTestName OBJECT-TYPE
SYNTAXSnmpAdminString(SIZE(0..32))MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"The name of the rsPing test. This is locally unique, within
the scope of an rsPingCtlOwnerIndex."::={ rsPingCtlEntry 2}rsPingCtlTargetAddressType OBJECT-TYPESYNTAX RsPingInetAddressType
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Specifies the type of host address to be used at a remote host
for performing a rsPing operation."DEFVAL{ unknown }::={ rsPingCtlEntry 3}rsPingCtlTargetAddress OBJECT-TYPESYNTAX RsPingInetAddress
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Specifies the host address to be used at a remote host for
performing a rsPing operation. The host address type is
determined by the object value of corresponding
rsPingCtlTargetAddressType.
A value for this object MUST be set prior to transitioning
its corresponding rsPingCtlEntry to active(1) via
rsPingCtlRowStatus."DEFVAL{ ''H }
::={ rsPingCtlEntry 4}rsPingCtlDataSize OBJECT-TYPESYNTAXUnsigned32(0..65507)UNITS"octets"MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Specifies the size of the data portion to be
transmitted in a rsPing operation in octets. A rsPing
request is usually an ICMP message encoded
into an IP packet. An IP packet has a maximum size
of 65535 octets. Subtracting the size of the ICMP
or UDP header (both 8 octets) and the size of the IP
header (20 octets) yields a maximum size of 65507
octets."DEFVAL{0}::={ rsPingCtlEntry 5}rsPingCtlTimeOut OBJECT-TYPESYNTAXUnsigned32(1..60)UNITS"seconds"MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Specifies the time-out value, in seconds, for a
remote rsPing operation."DEFVAL{3}
::={ rsPingCtlEntry 6}rsPingCtlProbeCount OBJECT-TYPESYNTAXUnsigned32(1..15)UNITS"probes"MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Specifies the number of times to perform a rsPing
operation at a remote host."DEFVAL{1}::={ rsPingCtlEntry 7}rsPingCtlAdminStatus OBJECT-TYPESYNTAXINTEGER{enabled(1),-- test should be starteddisabled(2)-- test should be stopped}MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Reflects the desired state that a rsPingCtlEntry should be
in:
enabled(1) - Attempt to activate the test as defined by
this rsPingCtlEntry.
disabled(2) - Deactivate the test as defined by this
rsPingCtlEntry.
Refer to the corresponding rsPingResultsOperStatus to
determine the operational state of the test defined by
this entry."DEFVAL{ disabled }::={ rsPingCtlEntry 8}rsPingCtlDataFill OBJECT-TYPESYNTAXOCTETSTRING(SIZE(0..1024))MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The content of this object is used together with the
corresponding rsPingCtlDataSize value to determine how to
fill the data portion of a probe packet. The option of
selecting a data fill pattern can be useful when links
are compressed or have data pattern sensitivities. The
contents of rsPingCtlDataFill should be repeated in a rsPing
packet when the size of the data portion of the rsPing
packet is greater than the size of rsPingCtlDataFill."DEFVAL{ '00'H }::={ rsPingCtlEntry 9}rsPingCtlFrequency OBJECT-TYPESYNTAXUnsigned32UNITS"seconds"MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The number of seconds to wait before repeating a rsPing test
as defined by the value of the various objects in the
corresponding row.
A single rsPing test consists of a series of rsPing probes.
The number of probes is determined by the value of the
corresponding rsPingCtlProbeCount object. After a single
test completes the number of seconds as defined by the
value of rsPingCtlFrequency MUST elapse before the
next rsPing test is started.
A value of 0 for this object implies that the test
as defined by the corresponding entry will not be
repeated."DEFVAL{0}::={ rsPingCtlEntry 10}rsPingCtlMaxRows OBJECT-TYPESYNTAXUnsigned32UNITS"rows"MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The maximum number of entries allowed in the
rsPingProbeHistoryTable. An implementation of this
MIB will remove the oldest entry in the
rsPingProbeHistoryTable to allow the addition of an
new entry once the number of rows in the
rsPingProbeHistoryTable reaches this value.
Old entries are not removed when a new test is
started. Entries are added to the rsPingProbeHistoryTable
until rsPingCtlMaxRows is reached before entries begin to
be removed.
A value of 0 for this object disables creation of
rsPingProbeHistoryTable entries."DEFVAL{50}::={ rsPingCtlEntry 11}rsPingCtlStorageType OBJECT-TYPE
SYNTAXStorageTypeMAX-ACCESSread-createSTATUScurrentDESCRIPTION"The storage type for this conceptual row.
Conceptual rows having the value 'permanent' need not
allow write-access to any columnar objects in the row."DEFVAL{ nonVolatile }::={ rsPingCtlEntry 12}rsPingCtlTrapGeneration OBJECT-TYPESYNTAXBITS{probeFailure(0),testFailure(1),testCompletion(2)}MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The value of this object determines when and if
to generate a notification for this entry:
probeFailure(0) - Generate a rsPingProbeFailed
notification subject to the value of
rsPingCtlTrapProbeFailureFilter. The object
rsPingCtlTrapProbeFailureFilter can be used
to specify the number of successive probe failures
that are required before a rsPingProbeFailed
notification can be generated.
testFailure(1) - Generate a rsPingTestFailed
notification. In this instance the object
rsPingCtlTrapTestFailureFilter can be used to
determine the number of probe failures that
signal when a test fails.
testCompletion(2) - Generate a rsPingTestCompleted
notification.
The value of this object defaults to zero, indicating
that none of the above options have been selected."::={ rsPingCtlEntry 13}rsPingCtlTrapProbeFailureFilter OBJECT-TYPESYNTAXUnsigned32(0..15)MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The value of this object is used to determine when
to generate a rsPingProbeFailed NOTIFICATION.
Setting rsPingCtlTrapGeneration
to probeFailure(0) implies that a rsPingProbeFailed
NOTIFICATION is generated only when the number of
successive probe failures as indicated by the
value of rsPingCtlTrapPrbefailureFilter fail within
a given rsPing test."DEFVAL{1}::={ rsPingCtlEntry 14}rsPingCtlTrapTestFailureFilter OBJECT-TYPESYNTAXUnsigned32(0..15)MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The value of this object is used to determine when
to generate a rsPingTestFailed NOTIFICATION.
Setting rsPingCtlTrapGeneration to testFailure(1)
implies that a rsPingTestFailed NOTIFICATION is
generated only when the number of rsPing failures
within a test exceed the value of
rsPingCtlTrapTestFailureFilter."DEFVAL{1}::={ rsPingCtlEntry 15}rsPingCtlType OBJECT-TYPESYNTAXOBJECTIDENTIFIERMAX-ACCESSread-createSTATUScurrentDESCRIPTION"The value of this object is used to either report or
select the implementation method to be used for
calculating a rsPing response time. The value of this
object MAY be selected from rsPingImplementationTypeDomains.
Additional implementation types SHOULD be allocated as
required by implementers of the REDSTONE-PING-MIB under
their enterprise specific registration point and not
beneath rsPingImplementationTypeDomains."DEFVAL{ rsPingIcmpEcho }::={ rsPingCtlEntry 16}rsPingCtlDescr OBJECT-TYPESYNTAXSnmpAdminStringMAX-ACCESSread-createSTATUScurrentDESCRIPTION"The purpose of this object is to provide a
descriptive name of the remote rsPing test."DEFVAL{ '00'H }
::={ rsPingCtlEntry 17}rsPingCtlSourceAddressType OBJECT-TYPESYNTAX RsPingInetAddressType
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Specifies the type of the source address,
rsPingCtlSourceAddress, to be used at a remote host
when performing a rsPing operation."DEFVAL{ ipv4 }::={ rsPingCtlEntry 18}rsPingCtlSourceAddress OBJECT-TYPESYNTAX RsPingInetAddress
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Use the specified IP address (which must be given
in numeric form, not as a hostname) as the source
address in outgoing probe packets. On hosts with
more than one IP address, this option can be used
to force the source address to be something other
than the primary IP address of the interface the
probe packet is sent on. If the IP address is not
one of this machine's interface addresses, an error
is returned and nothing is sent. A zero length
octet string value for this object disables source
address specification.
The address type (RsPingInetAddressType) that relates to
this object is specified by the corresponding value
of rsPingCtlSourceAddressType."DEFVAL{ ''H }::={ rsPingCtlEntry 19}
rsPingCtlIfIndex OBJECT-TYPESYNTAXInterfaceIndexOrZeroMAX-ACCESSread-createSTATUScurrentDESCRIPTION"Setting this object to an interface's ifIndex prior
to starting a remote rsPing operation directs
the rsPing probes to be transmitted over the
specified interface. A value of zero for this object
means that this option is not enabled."DEFVAL{0}::={ rsPingCtlEntry 20}rsPingCtlByPassRouteTable OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-createSTATUScurrentDESCRIPTION"The purpose of this object is to optionally enable
bypassing the route table. If enabled, the remote
host will bypass the normal routing tables and send
directly to a host on an attached network. If the
host is not on a directly-attached network, an
error is returned. This option can be used to perform
the rsPing operation to a local host through an
interface that has no route defined (e.g., after the
interface was dropped by routed)."DEFVAL{ false }::={ rsPingCtlEntry 21}rsPingCtlDSField OBJECT-TYPESYNTAXUnsigned32(0..255)
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"Specifies the value to store in the Differentiated
Services (DS) Field in the IP packet used to
encapsulate the rsPing probe. The DS Field is defined
as the Type of Service (TOS) octet in a IPv4 header
or as the Traffic Class octet in a IPv6 header.
The value of this object must be a decimal integer
in the range from 0 to 255. This option can be used
to determine what effect an explicit DS Field setting
has on a rsPing response. Not all values are legal or
meaningful. A value of 0 means that the function
represented by this option is not supported. DS Field
usage is often not supported by IP implementations and
not all values are supported. Refer to RFC 2474 for
guidance on usage of this field."REFERENCE"Refer to RFC 2474 for the definition of the
Differentiated Services Field and to RFC 1812
Section 5.3.2 for Type of Service (TOS)."DEFVAL{0}::={ rsPingCtlEntry 22}rsPingCtlRowStatus OBJECT-TYPESYNTAXRowStatusMAX-ACCESSread-createSTATUScurrentDESCRIPTION"This object allows entries to be created and deleted
in the rsPingCtlTable. Deletion of an entry in this
table results in all corresponding (same
rsPingCtlOwnerIndex and rsPingCtlTestName index values)
rsPingResultsTable and rsPingProbeHistoryTable entries
being deleted.
A value MUST be specified for rsPingCtlTargetAddress
prior to a transition to active(1) state being
accepted.
Activation of a remote rsPing operation is controlled
via rsPingCtlAdminStatus and not by changing
this object's value to active(1).
Transitions in and out of active(1) state are not
allowed while an entry's rsPingResultsOperStatus is
active(1) with the exception that deletion of
an entry in this table by setting its RowStatus
object to destroy(6) will stop an active
rsPing operation.
The operational state of a rsPing operation
can be determined by examination of its
rsPingResultsOperStatus object."REFERENCE"See definition of RowStatus in RFC 2579, 'Textual
Conventions for SMIv2.'"::={ rsPingCtlEntry 23}-- RsPing Results TablersPingResultsTable OBJECT-TYPESYNTAXSEQUENCEOF RsPingResultsEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Defines the RsPing Results Table for providing
the capability of performing rsPing operations at
a remote host. The results of these operations are
stored in the rsPingResultsTable and the rsPingPastProbeTable.
An entry is added to the rsPingResultsTable when an
rsPingCtlEntry is started by successful transition
of its rsPingCtlAdminStatus object to enabled(1).
An entry is removed from the rsPingResultsTable when
its corresponding rsPingCtlEntry is deleted."
::={ rsPingObjects 3}rsPingResultsEntry OBJECT-TYPESYNTAX RsPingResultsEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Defines an entry in the rsPingResultsTable. The
rsPingResultsTable has the same indexing as the
rsPingCtlTable in order for a rsPingResultsEntry to
correspond to the rsPingCtlEntry that caused it to
be created."INDEX{
rsPingCtlOwnerIndex,
rsPingCtlTestName
}::={ rsPingResultsTable 1}
RsPingResultsEntry ::=SEQUENCE{
rsPingResultsOperStatus INTEGER,
rsPingResultsIpTargetAddressType RsPingInetAddressType,
rsPingResultsIpTargetAddress RsPingInetAddress,
rsPingResultsMinRtt Unsigned32,
rsPingResultsMaxRtt Unsigned32,
rsPingResultsAverageRtt Unsigned32,
rsPingResultsProbeResponses Unsigned32,
rsPingResultsSentProbes Unsigned32,
rsPingResultsRttSumOfSquares Unsigned32,
rsPingResultsLastGoodProbe DateAndTime}rsPingResultsOperStatus OBJECT-TYPE
SYNTAXINTEGER{enabled(1),-- test is in progressdisabled(2)-- test has stopped}MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Reflects the operational state of a rsPingCtlEntry:
enabled(1) - Test is active.
disabled(2) - Test has stopped."::={ rsPingResultsEntry 1}rsPingResultsIpTargetAddressType OBJECT-TYPESYNTAX RsPingInetAddressType
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This objects indicates the type of address stored
in the corresponding rsPingResultsIpTargetAddress
object."DEFVAL{ unknown }::={ rsPingResultsEntry 2}rsPingResultsIpTargetAddress OBJECT-TYPESYNTAX RsPingInetAddress
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This objects reports the IP address associated
with a rsPingCtlTargetAddress value when the destination
address is specified as a DNS name. The value of
this object should be a zero length octet string
when a DNS name is not specified or when a
specified DNS name fails to resolve."DEFVAL{ ''H }::={ rsPingResultsEntry 3}rsPingResultsMinRtt OBJECT-TYPESYNTAXUnsigned32UNITS"milliseconds"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The minimum rsPing round-trip-time (RTT) received. A value
of 0 for this object implies that no RTT has been received."::={ rsPingResultsEntry 4}rsPingResultsMaxRtt OBJECT-TYPESYNTAXUnsigned32UNITS"milliseconds"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The maximum rsPing round-trip-time (RTT) received. A value
of 0 for this object implies that no RTT has been received."::={ rsPingResultsEntry 5}rsPingResultsAverageRtt OBJECT-TYPESYNTAXUnsigned32UNITS"milliseconds"MAX-ACCESSread-only
STATUScurrentDESCRIPTION"The current average rsPing round-trip-time (RTT)."::={ rsPingResultsEntry 6}rsPingResultsProbeResponses OBJECT-TYPESYNTAXUnsigned32UNITS"responses"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Number of responses received for the corresponding
rsPingCtlEntry and rsPingResultsEntry. The value of this object
MUST be reported as 0 when no probe responses have been
received."::={ rsPingResultsEntry 7}rsPingResultsSentProbes OBJECT-TYPESYNTAXUnsigned32UNITS"probes"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of this object reflects the number of probes sent
for the corresponding rsPingCtlEntry and rsPingResultsEntry.
The value of this object MUST be reported as 0 when no probes
have been sent."::={ rsPingResultsEntry 8}rsPingResultsRttSumOfSquares OBJECT-TYPESYNTAXUnsigned32UNITS"milliseconds"
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This object contains the sum of the squares for all rsPing
responses received. Its purpose is to enable standard
deviation calculation. The value of this object MUST
be reported as 0 when no rsPing responses have been
received."::={ rsPingResultsEntry 9}rsPingResultsLastGoodProbe OBJECT-TYPESYNTAXDateAndTimeMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Date and time when the last response was received for
a probe."::={ rsPingResultsEntry 10}-- RsPing Probe History TablersPingProbeHistoryTable OBJECT-TYPESYNTAXSEQUENCEOF RsPingProbeHistoryEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Defines a table for storing the results of a rsPing
operation. Entries in this table are limited by
the value of the corresponding rsPingCtlMaxRows
object.
An entry in this table is created when the result of
a rsPing probe is determined. The initial 2 instance
identifier index values identify the rsPingCtlEntry
that a probe result (rsPingProbeHistoryEntry) belongs
to. An entry is removed from this table when
its correspoding rsPingCtlEntry is deleted.
An implementation of this MIB will remove the oldest
entry in the rsPingProbeHistoryTable to allow the
addition of an new entry once the number of rows in
the rsPingProbeHistoryTable reaches the value specified
by rsPingCtlMaxRows."::={ rsPingObjects 4}rsPingProbeHistoryEntry OBJECT-TYPESYNTAX RsPingProbeHistoryEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Defines an entry in the rsPingProbeHistoryTable.
The first two index elements identify the
rsPingCtlEntry that a rsPingProbeHistoryEntry belongs
to. The third index element selects a single
probe result."INDEX{
rsPingCtlOwnerIndex,
rsPingCtlTestName,
rsPingProbeHistoryIndex
}::={ rsPingProbeHistoryTable 1}
RsPingProbeHistoryEntry ::=SEQUENCE{
rsPingProbeHistoryIndex Unsigned32,
rsPingProbeHistoryResponse Unsigned32,
rsPingProbeHistoryStatus RsPingOperationResponseStatus,
rsPingProbeHistoryLastRC Integer32,
rsPingProbeHistoryTime DateAndTime}rsPingProbeHistoryIndex OBJECT-TYPE
SYNTAXUnsigned32(1..'ffffffff'h)MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry in this table is created when the result of
a rsPing probe is determined. The initial 2 instance
identifier index values identify the rsPingCtlEntry
that a probe result (rsPingProbeHistoryEntry) belongs
to.
An implementation MUST start assigning
rsPingProbeHistoryIndex values at 1 and wrap after
exceeding the maximum possible value as defined by
the limit of this object ('ffffffff'h)."::={ rsPingProbeHistoryEntry 1}rsPingProbeHistoryResponse OBJECT-TYPESYNTAXUnsigned32UNITS"milliseconds"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The amount of time measured in milliseconds from when
a probe was sent to when its response was received or
when it timed out. The value of this object is reported
as 0 when it is not possible to transmit a probe."::={ rsPingProbeHistoryEntry 2}rsPingProbeHistoryStatus OBJECT-TYPESYNTAX RsPingOperationResponseStatus
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION
"The result of a particular probe done by a remote host."::={ rsPingProbeHistoryEntry 3}rsPingProbeHistoryLastRC OBJECT-TYPESYNTAXInteger32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The last implementation method specific reply code received.
If the ICMP Echo capability is being used then a successful
probe ends when an ICMP response is received that contains
the code ICMP_ECHOREPLY(0). The ICMP responses are defined
normally in the ip_icmp include file."::={ rsPingProbeHistoryEntry 4}rsPingProbeHistoryTime OBJECT-TYPESYNTAXDateAndTimeMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Timestamp for when this probe result was determined."::={ rsPingProbeHistoryEntry 5}-- Notification Definition sectionrsPingProbeFailed NOTIFICATION-TYPEOBJECTS{
rsPingCtlTargetAddressType,
rsPingCtlTargetAddress,
rsPingResultsOperStatus,
rsPingResultsIpTargetAddressType,
rsPingResultsIpTargetAddress,
rsPingResultsMinRtt,
rsPingResultsMaxRtt,
rsPingResultsAverageRtt,
rsPingResultsProbeResponses,
rsPingResultsSentProbes,
rsPingResultsRttSumOfSquares,
rsPingResultsLastGoodProbe
}STATUScurrentDESCRIPTION"Generated when a probe failure is detected when the
corresponding rsPingCtlTrapGeneration object is set to
probeFailure(0) subject to the value of
rsPingCtlTrapProbeFailureFilter. The object
rsPingCtlTrapProbeFailureFilter can be used to specify the
number of successive probe failures that are required
before this notification can be generated."::={ rsPingNotifications 1}rsPingTestFailed NOTIFICATION-TYPEOBJECTS{
rsPingCtlTargetAddressType,
rsPingCtlTargetAddress,
rsPingResultsOperStatus,
rsPingResultsIpTargetAddressType,
rsPingResultsIpTargetAddress,
rsPingResultsMinRtt,
rsPingResultsMaxRtt,
rsPingResultsAverageRtt,
rsPingResultsProbeResponses,
rsPingResultsSentProbes,
rsPingResultsRttSumOfSquares,
rsPingResultsLastGoodProbe
}STATUScurrentDESCRIPTION"Generated when a rsPing test is determined to have failed
when the corresponding rsPingCtlTrapGeneration object is
set to testFailure(1). In this instance
rsPingCtlTrapTestFailureFilter should specify the number of
probes in a test required to have failed in order to
consider the test as failed."::={ rsPingNotifications 2}rsPingTestCompleted NOTIFICATION-TYPEOBJECTS{
rsPingCtlTargetAddressType,
rsPingCtlTargetAddress,
rsPingResultsOperStatus,
rsPingResultsIpTargetAddressType,
rsPingResultsIpTargetAddress,
rsPingResultsMinRtt,
rsPingResultsMaxRtt,
rsPingResultsAverageRtt,
rsPingResultsProbeResponses,
rsPingResultsSentProbes,
rsPingResultsRttSumOfSquares,
rsPingResultsLastGoodProbe
}STATUScurrentDESCRIPTION"Generated at the completion of a rsPing test when the
corresponding rsPingCtlTrapGeneration object is set to
testCompletion(4)."::={ rsPingNotifications 3}-- Conformance information
-- Compliance statementsrsPingCompliances OBJECTIDENTIFIER::={ rsPingConformance 1}rsPingGroups OBJECTIDENTIFIER::={ rsPingConformance 2}
-- Compliance statementsrsPingCompliance MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for the REDSTONE-PING-MIB."MODULE-- this moduleMANDATORY-GROUPS{
rsPingGroup,
rsPingNotificationsGroup
}GROUP rsPingTimeStampGroup
DESCRIPTION"This group is mandatory for implementations that have
access to a system clock and are capable of setting
the values for DateAndTime objects. It is RECOMMENDED
that when this group is not supported that the values
for the objects in this group be reported as
'0000000000000000'H."OBJECT rsPingMaxConcurrentRequests
MIN-ACCESSread-onlyDESCRIPTION"The agent is not required to support set
operations to this object."OBJECT rsPingCtlStorageType
MIN-ACCESSread-onlyDESCRIPTION"Write access is not required. It is also allowed
for implementations to support only the volatile
StorageType enumeration."OBJECT rsPingCtlType
MIN-ACCESSread-onlyDESCRIPTION"Write access is not required. In addition, the only
value that MUST be supported by an implementation is
rsPingIcmpEcho."OBJECT rsPingCtlByPassRouteTable
MIN-ACCESSread-onlyDESCRIPTION"This object is not required by implementations that
are not capable of its implementation. The function
represented by this object is implementable if the
setsockopt SOL_SOCKET SO_DONTROUTE option is
supported."OBJECT rsPingCtlSourceAddressType
SYNTAX RsPingInetAddressType { unknown(0), ipv4(1), ipv6(2)}MIN-ACCESSread-onlyDESCRIPTION"This object is not required by implementations that
are not capable of binding the send socket with a
source address. An implementation is only required to
support IPv4 and IPv6 addresses."OBJECT rsPingCtlSourceAddress
SYNTAX RsPingInetAddress (SIZE(0|4|16))MIN-ACCESSread-onlyDESCRIPTION"This object is not required by implementations that
are not capable of binding the send socket with a
source address. An implementation is only required to
support IPv4 and globally unique IPv6 addresses."OBJECT rsPingCtlIfIndex
MIN-ACCESSread-only
DESCRIPTION"Write access is not required. When write access is
not supported return a 0 as the value of this object.
A value of 0 means that the function represented by
this option is not supported."OBJECT rsPingCtlDSField
MIN-ACCESSread-onlyDESCRIPTION"Write access is not required. When write access is
not supported return a 0 as the value of this object.
A value of 0 means that the function represented by
this option is not supported."OBJECT rsPingResultsIpTargetAddressType
SYNTAX RsPingInetAddressType { unknown(0), ipv4(1), ipv6(2)}DESCRIPTION"An implementation is only required to
support IPv4 and IPv6 addresses."OBJECT rsPingResultsIpTargetAddress
SYNTAX RsPingInetAddress (SIZE(0|4|16))DESCRIPTION"An implementation is only required to
support IPv4 and globally unique IPv6 addresses."::={ rsPingCompliances 1}-- MIB groupingsrsPingGroup OBJECT-GROUPOBJECTS{
rsPingMaxConcurrentRequests,
rsPingCtlTargetAddressType,
rsPingCtlTargetAddress,
rsPingCtlDataSize,
rsPingCtlTimeOut,
rsPingCtlProbeCount,
rsPingCtlAdminStatus,
rsPingCtlDataFill,
rsPingCtlFrequency,
rsPingCtlMaxRows,
rsPingCtlStorageType,
rsPingCtlTrapGeneration,
rsPingCtlTrapProbeFailureFilter,
rsPingCtlTrapTestFailureFilter,
rsPingCtlType,
rsPingCtlDescr,
rsPingCtlByPassRouteTable,
rsPingCtlSourceAddressType,
rsPingCtlSourceAddress,
rsPingCtlIfIndex,
rsPingCtlDSField,
rsPingCtlRowStatus,
rsPingResultsOperStatus,
rsPingResultsIpTargetAddressType,
rsPingResultsIpTargetAddress,
rsPingResultsMinRtt,
rsPingResultsMaxRtt,
rsPingResultsAverageRtt,
rsPingResultsProbeResponses,
rsPingResultsSentProbes,
rsPingResultsRttSumOfSquares,
rsPingProbeHistoryResponse,
rsPingProbeHistoryStatus,
rsPingProbeHistoryLastRC
}STATUScurrent
DESCRIPTION"The group of objects that comprise the remote rsPing
capability."::={ rsPingGroups 1}rsPingTimeStampGroup OBJECT-GROUPOBJECTS{
rsPingResultsLastGoodProbe,
rsPingProbeHistoryTime
}STATUScurrentDESCRIPTION"The group of DateAndTime objects."::={ rsPingGroups 2}rsPingNotificationsGroup NOTIFICATION-GROUPNOTIFICATIONS{
rsPingProbeFailed,
rsPingTestFailed,
rsPingTestCompleted
}STATUScurrentDESCRIPTION"The notification which are required to be supported by
implementations of this MIB."::={ rsPingGroups 3}END